STAC Items in Collection

This section explains how to retrieve all STAC Items within a specific collection.

A STAC Item represents an individual geospatial asset (e.g., a satellite image) and includes detailed metadata, geometry, timestamp, and asset links.

Endpoint

GET /public/stac/collections/{collectionId}/items

Include the following header:

x-api-key: YOUR_API_KEY

Example Request (cURL)

curl -H "x-api-key: YOUR_API_KEY" "https://giq.ae/public/stac/collections/d98629ef-58c5-9af8-714c-ac86b03fba66/items"

Example Response (Sample):

{
  "type": "FeatureCollection",
  "features": [
    {
      "type": "Feature",
      "id": "BSG-73-20240830-102222-194727757-ortho.zip",
      "title": "28658e5f-6b73-11ef-812d-19f768344900",
      "collection": "d98629ef-58c5-9af8-714c-ac86b03fba66",
      "geometry": {
        "type": "Polygon",
        "coordinates": [
          [
            [54.4062737, 24.466125],
            [54.4062737, 24.3901998],
            [54.4880255, 24.3901998],
            [54.4880255, 24.466125],
            [54.4062737, 24.466125]
          ]
        ]
      },
      "bbox": [54.4062737, 24.3901998, 54.4880255, 24.466125],
      "properties": {
        "datetime": "2024-08-30T10:22:22.004Z",
        "name": "BSG-73-20240830-102222-194727757-ortho.zip",
        "giq:layer_type": "RASTER",
        "description": null,
        "giq:ingestion_date": "2024-09-05T10:39:27Z",
        "source_type": "MULTISPECTRAL",
        "giq:source": "BLACKSKY",
        "giq:source_type": "MULTISPECTRAL",
        "giq:source_sub_type": "DEFAULT",
        "layer_type": "RASTER"
      },
      "assets": {
        "rendered_preview": {
          "href": "https://giq.ae/api/map/preview?bbox=54.4062737,24.3901998,54.4880255,24.466125&sourceId=28658e5f-6b73-11ef-812d-19f768344900&width=160&height=160",
          "title": "Rendered preview",
          "type": "image/png",
          "roles": ["overview"]
        },
        "data": {
          "href": "https://minio.giq.ae/.../BSG-73-20240830-102222-194727757-ortho.zip?...",
          "title": "Source File",
          "type": "application/zip",
          "roles": ["data"]
        }
      },
      "links": [
        {
          "rel": "self",
          "href": "https://giq.ae/public/stac/collections/d98629ef-58c5-9af8-714c-ac86b03fba66/items/28658e5f-6b73-11ef-812d-19f768344900",
          "type": "application/geo+json",
          "title": "STAC Item",
          "method": "GET"
        },
        {
          "rel": "collection",
          "href": "https://giq.ae/public/stac/collections/d98629ef-58c5-9af8-714c-ac86b03fba66",
          "type": "application/json",
          "title": "STAC Collection",
          "method": "GET"
        }
      ],
      "stac_version": "1.0.0",
      "stac_extensions": [
        "https://stac-extensions.github.io/view/v1.0.0/schema.json",
        "https://stac-extensions.github.io/sar/v1.2.0/schema.json"
      ]
    }
  ],
  "links": [
    {
      "rel": "self",
      "href": "/public/stac/collections/d98629ef-58c5-9af8-714c-ac86b03fba66/items",
      "type": "application/geo+json",
      "title": "Current page",
      "method": "GET"
    }
  ]
}

Response Overview

Returns a list of STAC Items belonging to a specific collection. Each item includes:

• ID and title
• Geometry (e.g., polygon coordinates)
• Temporal coverage
• Asset previews and download links
• Ingestion metadata

Response Fields

Field	Description
type	Always FeatureCollection
features	Array of STAC Item objects
features.id	Unique ID for each item
properties	Metadata including acquisition date, source, etc
geometry	GeoJSON polygon of the item footprint
assets	Associated downloadable resources
links	Navigation links to related endpoints

Response Links

Rel	Description	URL Template
self	Link to the current items endpoint	/public/stac/collections/{collectionId}/items
collection	Link back to the parent collection	/public/stac/collections/{collectionId}

Assets

Key	Description	Type
rendered preview	Image preview of the data	image/png
data	Downloadable source file (e.g. GeoTIFF)	application/zip

Use Cases

• Retrieve all imagery or data assets for a given satellite collection
• Programmatically browse items before download or analysis
• Build visualization tools using preview links and geometry
• Filter items manually before advanced search or ordering